AC Companion and Tings
By Flipo of Solclaim
11/24/2010

NOTE THIS DOCUMENT MAY NOT MATCH EXACTLY WHAT YOU SEE BUT IT SHOULD BE CLOSE.

	AC Companion is an application that allows you to view your Asheron's Call toon's entire inventory.  AC Companion will allow you to View, Sort and go crazy with all the inventory information available. It should make happy the 'spreadsheet' group of players and yet still allow others to 'Keep it Simple' and just use the IG plugin features. So to begin with you may want to stick with the IG Tings HUD abilities and then brave forth to seeing what AC Companion can do to overwhelm you with information. 

Features
•	Track inventory items for all toons on all servers.
•	IG HUD to find items and see information about item.
•	Ability to maintain inventory while using different PCs on your local LAN or multiple AC sessions on one computer.
•	Ability to review inventory while not IG.
•	Ability to customize and add views.
•	Ability to Export all or selected inventory data to a CSV file.
•	Inventory toons level, skill, augs etc

Notes
•	Tings will work without firebird or ACCompanion but you will also then be doing without the Inventory feature.
•	Always start ACCompanion before getting IG. Minimize if you want.
•	Expect that items in inventory will not be 100% accurate.
•	

"There can only be one" rule.
•	One PC with firebird server running and AsheronCall database on it.
•	One AC Companion configured correctly and running per PC. 
•	One Tings plug-in with inventory enabled for each AC game session.

Installation

1. Download Tings MSI from the web site.
    http://flipo.roogon.com/ 

2. If you do not have Firebird server installed on any PC in your local LAN then below will help you install it.

Note: You only need to install Firebird server on one pc on your local LAN. So if you have multiple PC then
you may want to choose the PC that is always on when you play AC.

You can get the Firebird installer from
http://www.firebirdsql.org/index.php?op=files&id=engine_250

Uses either

Firebird-2.5.0.26074_1_Win32.exe

Firebird-2.5.0.26074_1_x64.exe

Run the firebird install and basically accept the defaults. 
I typically choose 'Classic' but you may want "Super Server".

3. Run Tings installer on the PC that you installed Firebird on.

4. Once Tings is installed start ACCompanion (There should be a Desktop Icon for it).

5. ACCompanion should start up.  If not you may need to set ACCompanion.exe to Run as Administrator. If that does not help read step 7 and see if the path is correct for your installation. 

6. Run Tings installer on any other PC you play on. You may have to uninstall prior version of Tings.

7. If there is a connection issue then ACCompanion will open the Configurations->Server Setup tab and allow you to set the Firebird Connection Path. If this is the PC you installed Firebird on then make note of the IP address on this screen, as this is the IP address of the server which you will need in order to install on other PCs.

    You will need to edit the Firebird Connection Path and press the set button.

    The Firebird Connection Path consists of 'Server:Path'.  If on same box as firebird server then use 'localhost' otherwise use the IP address of PC that has firebird installed. The path is the file path to where the database file is stored on the PC that is running firebird server.

    Example:  ACCompanion installed on PC where firebird is installed. When I installed Tings
	 I installed into "C:\Games\Tings" directory, so my Firebird Connection Path is the following.
    
 	localhost:C:\Games\Tings\AsheronCall.FDB
           
           I make note of IP on this PC as it is where Firebird is installed( 192.168.0.188).          

    Example: I install Tings on different PC that does not have Firebird installed.
       I set the Firebird Connection Path to the following and press set.
        192.168.0.188:C:\Games\Tings\AsheronCall.FDB

    You may find that connecting to PC where Firebird server is running does not work. Check Firewall settings on the PC that has Firebird Server.

8. In order for ACCompanion to have any data you will need to get IG on toons and do a Full inventory scan.
   So while AC Companion is up go ahead and get in game and click on Full Button shown below.

9. Now confirm that we are working. On AC Companion Inventory Tab select your server.

    
If your unable to find a game server then there is a communication problem between the Tings Plugin and AC Companion. It may be your installation needs AC Companion to run as Administrator. Close AC Companion then you will need to set AC Companion to run as Administrator. One way to do this is to right click on the AC Companion shortcut (on your desktop) select the compatibility tab. Select "Run as Administrator".  Go back to step 8 and retest. 

Enjoy!

      
      
Updates

    Once you have initially installed you should be able to use future Tings MSI to update without loss of data. You will need to make note of where you installed Tings on the PC then do an uninstall then use new Tings MSI and install to same directory as you did before.

TINGS

This document applies to Tings Inventory feature and does not document the other functions of Tings.

Inventory Main Tab

	 

Information Page is currently on Yellow paper. You may move this window by dragging by upper left corner.
Clicking on the upper right part to close.
> symbol shows group name that applies to items listed below it.

This must be green in order to Enable Inventory to work. ACCompanion must be running as well.
This can be disabled if needed but you will have to remember to enable later and do a full scan to fix inventory.

Enter search information and use Search button. You may use ';' between search items to help 
narrow your search. You may also prefix a search item with '!' to mean 'Not'.

Example:  BOW;360
  This will show items that have the word BOW and the number 360.

Example: Bow;!Crossbow
If we just used bow we would also find crossbows. So adding the !Crossbow solves the problem.

Example:  Amuli

  Click on an item in this box and you will get the Yellow information page on that item.

 Click on item in your toon's pack and then click Info button to see the yellow information page on this item.

 If you enable the Auto Info then when you select an item on your toon you will see the information page if it exists.

This will scan all items on toon and update Inventory program.
You will need to wait IG until all items are ID. Buff time is good time to do this. 

This will give provide you with item counts for what is known by server vs. what is known by your toon. If Server does not have all the items that your toon does Tings inventory will begin to ID missing items it needs. This will also set the pack and slots. This will also update your CharacterInformation.
Note: Do not expect Pack and slot information to be %100 

AC Companion

This is where a lot of information about inventory items is provided. It can be overwhelming depending on how far you want to go with it.
You can keep it simple by just using the basic features. The basic features are on the Inventory and General tabs. Leave the Views tab 
for when your willing to spend some time figuring things out.

Note: I refer to that white spreadsheet looking thing at bottom as the grid. This is the place where items will be shown.
  If you click on any item in the grid then that item's information will appear on the Inventory tab.

Inventory Tab

Pick a game server by using the down arrow button. (I have mine set to 'Solclaim')
You now have three ways to access your inventory items.
•	By Search 
•	By View
•	By Class

Enter search information and use Search button. You may use ';' between search items to help narrow your search.

Example:  BOW;360
  This will show items that have the word BOW and the number 360.

Just click on item in the GRID to see information.

Use the down arrow button and select a View.

Just click on item in the GRID to see information.

You can Pick a toon or leave it with 'Pick a Toon' or 'All' showing.
Select class of item you wish to see.

Just click on item in the GRID to see information.

GENERAL TAB

This will change I'm sure. For now I have provided Buttons that perform useful searches into the inventory.

Export Inventory will export all Inventory data into a CSV file.
Export Current will export Current Inventory Grid data into a CSV file.

Configurations Options Tab

Show ID Info Requests: This allows AC Companion to follow ID requests done IG.

Show Icon images: This Controls the showing of ICON images in the inventory grid. The GRID will change size depending on this setting.

This Computer’s IP: Show the IP for this PC. Useful numbers to know when you setup.

Help button will show this document.

Fix 101 button is a temporary button and you should not use at this time.

Configurations Server Setup Tab

This is the place where you provide AC Companion with the knowledge of where the Firebird database is located.

Character Information Tab

Delete button will Delete the character information. It does not remove the Inventory data for that toon.
You may click on a toon in the grid or use the 'Select a Toon' to obtain information on a particular toon.
You may also click on Attributes,Skills,Augs,Vassals,Titles to see the respective information.
  (If you select Titles the number of titles is show to the right i.e. #35 )
Export button will Export Character information to a CSV file.

View Tab

This is where you can add, modify and delete Views of data.

Update Views: This will update views that I release with each new Tings.msi. These are the ViewNames with + in names.
Export current view: Save this view's XML to clipboard.
Import View: Will import a view XML.

END of Document